home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / pxfgetpwuid.z / pxfgetpwuid
Encoding:
Text File  |  1998-10-30  |  4.1 KB  |  102 lines
  1. PXFGETPWUID(3F)                                        Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      PPXXFFGGEETTPPWWUUIIDD - Gets password information by using user ID
  6.  
  7. SSYYNNOOPPSSIISS
  8.      SSUUBBRROOUUTTIINNEE PPXXFFGGEETTPPWWUUIIDD ((_n_a_m_e,, _i_u_i_d,, _j_p_a_s_s_w_d,, _i_e_r_r_o_r))
  9.      IINNTTEEGGEERR _i_u_i_d,, _j_p_a_s_s_w_d,, _i_e_r_r_o_r
  10.  
  11. IIMMPPLLEEMMEENNTTAATTIIOONN
  12.      UNICOS, UNICOS/mk, and IRIX systems
  13.  
  14. SSTTAANNDDAARRDDSS
  15.      IEEE standard interface for FORTRAN 77
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.      On IRIX systems, this routine is in lliibbffoorrttrraann..ssoo which is linked by
  19.      default when compiling programs with the MIPSpro 7 Fortran 90 compiler
  20.      or when compiling programs with the --ccrraayylliibbss option to the MIPSpro
  21.      7.2 F77 compiler.
  22.  
  23.      PPXXFFGGEETTPPWWUUIIDD uses the ggeettppwwuuiidd(3C) function to return password
  24.      information about a user ID. It uses the following components of the
  25.      ppaasssswwdd structure:
  26.  
  27.      * ppww__nnaammee: login name
  28.  
  29.      * ppww__uuiidd: user ID
  30.  
  31.      * ppww__ggiidd: group ID
  32.  
  33.      * ppww__ddiirr: default login directory
  34.  
  35.      * ppww__sshheellll: default login shell or program
  36.  
  37.      The following components are supported by the UNICOS and IRIX
  38.      operating systems, but are not part of the POSIX 1003.9-1992 standard.
  39.  
  40.      * ppww__ppaasssswwdd: encrypted password
  41.  
  42.      * ppww__aaggee: password age (character string) (unused on IRIX systems)
  43.  
  44.      * ppww__ccoommmmeenntt:: ccoommmmeenntt
  45.  
  46.      ** ppww__ggeeccooss: a comment in the UNICOS operating system; the user's real
  47.        name on IRIX systems.
  48.  
  49.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  50.      UNICOS, UNICOS/mk, or IRIX systems, all arguments must be of default
  51.      kind unless documented otherwise.  On UNICOS and UNICOS/mk, default
  52.      kind is KKIINNDD==88 for integer, real, complex, and logical arguments; on
  53.      IRIX, the default kind is KKIINNDD==44.
  54.  
  55.      The following is a list of valid arguments for this routine:
  56.  
  57.      _n_a_m_e      An input character variable or array element containing the
  58.                login name for which password information is requested.
  59.  
  60.      _i_u_i_d      An input integer variable containing the user ID for which
  61.                password information is requested.
  62.  
  63.      _j_p_a_s_s_w_d   An output handle of type ppaasssswwdd created with
  64.                PPXXFFSSTTRRUUCCTTCCRREEAATTEE(3F).
  65.  
  66.      _i_e_r_r_o_r    An output integer variable that contains zero if PPXXFFGGEETTPPWWUUIIDD
  67.                was successful or nonzero if PPXXFFGGEETTPPWWUUIIDD was not successful.
  68.  
  69.      The PPXXFFGGEETTPPWWUUIIDD routine may return the following errors:
  70.  
  71.      EENNOOEENNTT       If an entry matching the user ID in _i_u_i_d was not found.
  72.  
  73.      EEBBAADDHHAANNDDLLEE   If _j_p_a_s_s_w_d is an invalid handle or has an incorrect
  74.                   handle type (UNICOS and UNICOS/mk systems only).
  75.  
  76. EEXXAAMMPPLLEESS
  77.      In this example, the password information will be acquired for the
  78.      login name rroooott.
  79.  
  80.           program pxftest
  81.           integer iuid, ierror, value
  82.           integer*8 jpasswd
  83.  
  84.           CALL PXFSTRUCTCREATE('passwd',jpasswd,ierror)
  85.           iuid=0
  86.           CALL PXFGETPWUID(iuid,jpasswd,ierror)
  87.           if (ierror .eq. 0) then
  88.              print *,'PASSED: pxfgetpwuid call'
  89.                 else
  90.              print *,'FAILED: pxfgetpwuid call with error = ',ierror
  91.           endif
  92.  
  93.           CALL PXFSTRUCTFREE(jpasswd,ierror)
  94.           end
  95.  
  96. SSEEEE AALLSSOO
  97.      ggeettppwwnnaamm(3C), PPXXFFSSTTRRUUCCTTCCRREEAATTEE(3F), PPXXFFSSTTRRUUCCTTFFRREEEE(3F)
  98.  
  99.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  100.      2165, for the printed version of this man page.
  101.  
  102.